home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 049a / ramail22.zip / RAMAIL.DOC < prev    next >
Text File  |  1991-03-16  |  19KB  |  419 lines
  1.  
  2.  
  3.  
  4.                                   RAMail DOOR 2.2
  5.                       Copyright 1990, 1991 by Randy Blackmond
  6.                                 All Rights Reserved
  7.  
  8.      Welcome to RAMail, the mail system exclusively for RemoteAccess!
  9.  
  10.      This version will probably not work with any RA versions prior to 1.00.
  11.  
  12.      THE DOOR
  13.      --------
  14.      The RAMail Door is only half of the complete system. The other half
  15.      is a reader. You, as a sysop, don't need a reader for your door to 
  16.      function, but your users will so they can read and reply to the mail
  17.      in the packets the door produces. I recommend The Silly Little Mail
  18.      Reader, but Session Manager, Qmail or EZ-Reader will also work.
  19.  
  20.      The RAMail Door accesses MOST of your RA system files. All reasonable 
  21.      precautions have been taken to ensure that RAMail will not damage any of
  22.      these files, but it is recommended that you backup all of your BBS system
  23.      files before running the RAMail Door for the first time.
  24.  
  25.      INSTALLATION
  26.      ------------
  27.      The first thing you need to do is to create a RAMAIL.CFG file by running
  28.      the RAMCONF.EXE program. You must supply the name of the CFG file you wish
  29.      to create/edit on the command line with RAMCONF. The fields are described
  30.      below:
  31.  
  32.      Sysop Name
  33.           Your Name
  34.  
  35.      Registration Number
  36.           0 if unregistered or your registration number
  37.  
  38.      BBS Code
  39.           This is a 8 character or less name that will be used to name your 
  40.           QWK files.
  41.  
  42.      Path to CONFIG.RA
  43.           Path to your RA system directory with a trailing \
  44.  
  45.      Path to EXITINFO.BBS
  46.           This field is for multiple node boards. It allows you to have
  47.           multiple CFG files and tells RAMail where to look for the 
  48.           node-specific files. If you run a single node system, this field
  49.           should be identical to the previous field.
  50.  
  51.      Path to DSZ.COM
  52.           The full path and filename to DSZ.COM.
  53.  
  54.      Path to PKZIP.EXE
  55.           The full path and filename to PKZIP.EXE
  56.  
  57.      Path to PKUNZIP.EXE
  58.           The full path and filename to PKUNZIP.EXE
  59.  
  60.  
  61.  
  62.      Path to RAUSER.DAT
  63.           This field is for multiple node boards. It allows all nodes to use
  64.           the same RAMail data file. If you run a single node system, you will
  65.           still need to fill this field appropriately.
  66.  
  67.      Local Mail Directory
  68.           This field allows you to tell RAMail where you want QWK packets for
  69.           local logons to be placed. Local REP files are also expected to be
  70.           in this directory. A valid drive and directory is required.
  71.  
  72.      Required Conferences
  73.           Lets you specifiy which, if any, of your message boards you wish to
  74.           force into your users QWK packets. Each board number should be
  75.           separated by a single space. If you do not wish to force any boards,
  76.           leave this field blank.
  77.  
  78.      Local Msg Limit
  79.           The highest number of messages RAMail will include in a QWK generated
  80.           from a local logon.
  81.  
  82.      300 Baud Msg Limit
  83.           The highest number of messages RAMail will include in a QWK generated
  84.           for a 300 baud caller.
  85.  
  86.      1200 Baud Msg Limit     
  87.           The highest number of messages RAMail will include in a QWK generated
  88.           for a 1200 baud caller.
  89.      
  90.      2400 Baud Msg Limit     
  91.           The highest number of messages RAMail will include in a QWK generated
  92.           for a 2400 baud caller.
  93.  
  94.      9600 Baud Msg Limit     
  95.           The highest number of messages RAMail will include in a QWK generated
  96.           for a 9600+ baud caller.
  97.  
  98.      Default File EXT
  99.           The file extension you use on your BBS downloadable files, e.g. ZIP,
  100.           ARC, PAK, LZH, etc.
  101.  
  102.      Enable File Downloads
  103.           Allows you to disable the [F]iles function of RAMail.
  104.  
  105.      Enable Hi Bit Filter
  106.           If you run a FIDO board, you will want to enable this feature. Other-
  107.           wise, you can disable it. It replaces all characters in uploaded
  108.           messages that are above ASCII 127 with an asterisk (*).
  109.  
  110.      Sec Lvl for PRVT Msgs
  111.           Anyone with a security level matching this field or higher will be
  112.           able to receive private mail addressed to anyone in their packets.
  113.  
  114.      Force reply FROM name
  115.           This allows you to force imported messages from users to have the
  116.           name in the FROM field match the users' logon name.
  117.  
  118.  
  119.  
  120.      There are 3 display files that are included in the QWK packet for the
  121.      offline readers. One is a welcome screen, one is a news screen and the
  122.      third is a goodbye screen. In previous versions of RAMail, the screens
  123.      used were your WELCOME.A*, NEWS.A* and GOODBYE.A* files. In this version,
  124.      your can elect to provide separate screens for the QWK packets. If you
  125.      choose to use this option, the file names you must use are HELLO, INFO
  126.      and BYE for the ASCII version and HELLOG, INFOG and BYEG for the Ansi
  127.      versions. These files, if used, must reside in the same directory as
  128.      RAMail. If these files are not found during packet creation, the BBS
  129.      screens will be used as before.
  130.  
  131.      Code 7 Setup
  132.      ------------
  133.      Put RAMAIL.EXE and RAMAIL.CFG in your RA system directory. The menu entry
  134.      for RAMail should be as follows:
  135.  
  136.      Optional Data: RAMAIL.EXE RAMAIL.CFG *M
  137.  
  138.      You should use RA's swapping to ensure there is enough memory for RAMail
  139.      to run. To do this put *M after RAMAIL.EXE RAMAIL.CFG on your Optional
  140.      Data line. Failure to do so will probably result in not enough memory
  141.      being available for RAMail to call PKZIP, PKUNZIP and DSZ.
  142.  
  143.      Code 15 Setup
  144.      -------------
  145.      First, create a directory on your hard drive in which RAMail will reside.
  146.      Place the RAMAIL.EXE program and the RAMAIL.CFG files into that directory.
  147.  
  148.      Create a batch file like the one below:
  149.  
  150.      @echo off
  151.      cd \RA\RAMAIL
  152.      RAMAIL RAMAIL.CFG
  153.      cd \RA
  154.  
  155.      Note that the name of the CFG file you created is passed to RAMAIL.EXE on
  156.      the command line. Also, ANSI.SYS or some facsimile must be loaded to
  157.      enable you to see the ANSI colors the door uses locally. Loading ANSI.SYS
  158.      is not necessary for successful operation of the door, however.
  159.  
  160.      Place the batch file in your RA directory and add the door to your menu
  161.      the same way you add any level 15 door.
  162.  
  163.      Please realize that the QWK mail packet format is based on the PCBoard
  164.      message standard. What RAMail is basically doing is translating your RA
  165.      messages into PCBoard messages. One annoyance that will probably occur
  166.      is that your board names (referred to as "conferences" in the PCBoard
  167.      world) will be truncated to 10 characters when listed in the readers since
  168.      that is the limit to conference names for PCBoard! You could let your
  169.      RAMail users suffer through this minor annoyance, rename your boards OR
  170.      set up RACONFS.LST.
  171.  
  172.      RAMail will look in the current directory for a file named RACONFS.LST
  173.      to use when inserting conference names into the QWK packet. This allows
  174.      you to retain your 30 character board descriptions in RA and still have
  175.      short, meaningful names for your users' readers! The format of this file
  176.      follows (NO BLANK LINES):
  177.  
  178.  
  179.      
  180.      Conf#
  181.      ConfName
  182.      Conf#
  183.      ConfName
  184.      etc...
  185.      
  186.      Example:
  187.      
  188.      1
  189.      Main Board
  190.      2
  191.      Games
  192.      3
  193.      Telecom
  194.      4
  195.      Private
  196.  
  197.      NOTES
  198.      -----
  199.      The RAUSER.DAT file has changed formats from v2.1. Use the included
  200.      USRTRANS.EXE to update your RAUSER.DAT or just delete it and start fresh.
  201.      Also, place the included DOOR.ID in the same directory(s) as your
  202.      RAMAIL.CFG file(s).
  203.  
  204.      If you are running under a network such as Novell or Lantastic and you
  205.      experience the problem of RAMail not executing PKZIP, PKUNZIP or DSZ
  206.      properly, there is an alternate version available that may solve this
  207.      problem for you. It is available as RAM22A.ZIP from my BBS.
  208.  
  209.      USAGE
  210.      -----
  211.      The menu for RAMail is straightforward. You have 15 options: Conference
  212.      Selection, Download, Upload, Modify Last Read Pointer, File Areas, Page,
  213.      System Info, Bulletin Toggle, Transfer Protocol, Help, New Files, Express
  214.      Mail Run, Include New Files Toggle, Quit and Goodbye.
  215.  
  216.      Conference Selection allows your users to decide which message boards they
  217.      wish to be included in their downloaded mail. It will display all available
  218.      message boards and allow them to pick which ones they want. The config-
  219.      uration the user chooses will be saved in a mini user file maintained by
  220.      RAMail. They can change their configuration at any time. Users will
  221.      not be allowed to choose boards for which they do not have a high enough
  222.      security level and/or a set Read Flag to read. 
  223.  
  224.      The Download option extracts all new mail for the configuration the user
  225.      has chosen and places them in a compressed ZIP packet and then invokes
  226.      a DSZ Zmodem send of the packet. 
  227.  
  228.      The Upload option invokes a DSZ Zmodem receive of a reply packet that
  229.      will be named [BBSCODE].REP. It will then UNZIP the packet and import
  230.      the replies to your message files where they will be available immediately
  231.      for reading.
  232.  
  233.      The Modify Last Read Pointer option allows the user to change their last
  234.      read pointer. The option will not let the user set their point higher than
  235.      the highest numbered message in the system.
  236.  
  237.  
  238.  
  239.      The File Areas option allows users to view your file lists and flag files
  240.      to be downloaded with their mail packet. Checking is done to ensure the
  241.      user has access to a given file area according to security level and flag
  242.      settings. Full support of LIMITS.CTL is provided automatically as well.
  243.      The maximum number of files a user can flag for download is 5. This option
  244.      can be disabled if the sysop chooses to do so.
  245.  
  246.      The Page option allows the user to page the Sysop for a chat.
  247.  
  248.      The System Info option displays message stats, total calls and last caller
  249.      information.
  250.  
  251.      The Bulletin Toggle allows the user to enable/disable the inclusion of
  252.      new bulletins in his/her mail packet.
  253.  
  254.      The Transfer Protocol option allows the user to select a download protocol
  255.      to be used when performing mail/file transfers. This option is initially
  256.      set to Zmodem for new users.
  257.  
  258.      The Help option will display the file RAMAIL.HLP. You can use the included
  259.      file or create your own.
  260.  
  261.      The New Files option will search all available file directories for files
  262.      newer than (or equal to) the date of the user's last call and list them to
  263.      the screen.
  264.  
  265.      The Express Mail Run option will cause RAMail to create the mail packet
  266.      and then immediately send it. Upon completion of the transfer, the user
  267.      will be logged off.
  268.  
  269.      The Include New Files Toggle option enables/disables the new files scan
  270.      that RAMail performs during packet creation.
  271.  
  272.      The Quit option returns the user to the BBS.
  273.  
  274.      The Goodbye option disconnects the caller and exits the door.
  275.      
  276.      Users can select the board configuration they want by entering special 
  277.      offline messages. If a message is addressed to RAMAIL or QMAIL the
  278.      subject will determine the configuration action to be taken. The choices
  279.      for the subject are as follows:
  280.  
  281.      ADD      - Adds a conference and selects all mail
  282.      ADD A    - Adds a conference and selects all mail
  283.      ADD Y    - Adds a conference and selects your mail only
  284.      ADD YA   - Adds a conference and selects your  mail and mail to All
  285.      DROP     - Drops a conference
  286.  
  287.      HISTORY
  288.      -------
  289.      1.0   Initial release of RAMail!
  290.  
  291.      1.1   Increased the speed of the message export process TREMENDOUSLY!
  292.            200 message packets should be created in about 30 seconds or so.
  293.            Did away with the idea of conference pointers. There's just no
  294.            feasible way to do something like that with RA. The last read
  295.            message pointer will be read from the user's record upon entry
  296.            into RAMail and updated after downloading a packet.
  297.  
  298.      1.2   This version was released as a fix for the problem of the last read
  299.            message pointer not being updated. Too bad it didn't fix it!
  300.  
  301.  
  302.  
  303.      1.3   Discovered reason for the read pointer not being updated (I thought)
  304.            Added different message download limits for each baud rate (See
  305.            INSTALLATION). Added Hot Keys.
  306.  
  307.      1.4   Finally! An enhancement version! The Configuration option has been
  308.            enhanced to allow the user to elect to receive only their mail and
  309.            mail addressed to All or All mail. Added the Modify Last Read 
  310.            Pointer option. Added optional RACONFS.LST board name file. Last
  311.            Read Message Pointer problem was finally solved!
  312.  
  313.      1.5   Stomped a few more bugs. Added FIDO Default Origin line support for 
  314.            messages uploaded to an EchoMail board. Increased packet processing
  315.            speed even more. RA's message indexes are automatically updated by
  316.            RAMail when replies are uploaded. New RAMCONF program eases creation
  317.            and modification of your RAMAIL.CFG file(s). Added support for
  318.            multiple nodes. RAMail should now work properly on boards where the
  319.            message files reside in their own directory. Much more!
  320.  
  321.      2.0   Still more bugs stomped. Should now be completely FIDO compatible.
  322.            Added Files feature, Your Mail Only mail selector, high ASCII filter
  323.            option for FIDO boards, Personal Mail support, New Files and New
  324.            Bulletins support, Default Protocol, Online Help, Goodbye from the
  325.            menu or after transfer and more!
  326.  
  327.      2.01  Maintenance release. The message attributes set by RAMail were all
  328.            messed up resulting in such problems as imported EchoMail messages
  329.            not being marked as pending export and private messages not being
  330.            marked or recognized as private.
  331.  
  332.      2.1   Added path for RAUSER.DAT in RAMCONF.EXE. This was to allow multiple 
  333.            node systems to use the same RAUSER.DAT file for all nodes. Added
  334.            (S)elect All and (D)eselect All in the configuration option.
  335.  
  336.      2.2   Added support for the DOOR.ID file that SLMR 2.0 will make use of.
  337.            Added offline mail configuration support. RAMail will write to your
  338.            system log(s) when mail/files are download/uploaded. Origin lines
  339.            are attached to incoming echo mail only if Echo Info is enabled in
  340.            your RACONFIG. Stomped a few bugs.
  341.  
  342.      DISCLAIMER
  343.      ----------
  344.      As stated before, all reasonable precautions have been take to ensure
  345.      that your system files will not be damaged, but if any damage does
  346.      occur caused by RAMail either directly or indirectly, I will not
  347.      be held responsible for such damages. USE THIS PRODUCT AT YOUR OWN RISK!
  348.      
  349.      CREDITS
  350.      -------
  351.      This Door was written with JPDOOR 3.0 Copyright 1991 by Rod Hancock
  352.      PKZIP/PKUNZIP is Copyright 1989-1991 by PKWARE, Inc.
  353.      DSZ is Copyright 1991 by Omen Technology INC
  354.      QuickBBS is Copyright 1990 by The QuickBBS Group, Inc.
  355.      RemoteAccess is Copyright 1991 by Continental Software
  356.      Session Manager is copyright 1991 by Patrick Hart
  357.      EZ-Reader is copyright 1988-1991 by Thumper Technologies
  358.      Qmail is copyright 1987-1991 by Sparkware
  359.      Silly Little Mail Reader is copyright 1991 by Greg Hewgill and
  360.                                                    Computer Techniques
  361.  
  362.      And special thanks to my beta testers for their patience, support and
  363.      wonderful suggestions!
  364.  
  365.  
  366.  
  367.      PROBLEMS & SUGGESTIONS
  368.      ----------------------
  369.      Bug reports, problems, suggestions and comments can be made to Randy
  370.      Blackmond in the RIME/RelayNet Doors, Sysops, Shareware or RA conference
  371.      or call Randy's Basement BBS 1200/2400/9600 USR DS at (505) 589-0319.
  372.      If you call the BBS, don't be surprised to find PCBoard instead of RA! I
  373.      find the market for QuickBBS/RA software more open to new products. I
  374.      STRONGLY encourage users to give suggestions for new features they would
  375.      like to see implemented!
  376.  
  377.      REGISTRATION
  378.      ------------
  379.      Usage of the RAMail Door for longer than a 2 week evaluation period
  380.      requires that you register the product with the author. Failure to do
  381.      so violates Federal Copyright Laws and places you in a position to which
  382.      the author can pursue monetary damages in a court of law. Why risk it?
  383.      Register the software. Registration entitles you to free upgrades forever
  384.      and access to beta versions as they appear on my BBS.
  385.  
  386.      To register the RAMail Door, you have two options. 1) Complete the
  387.      following form and mail it back to the author with a check or money order
  388.      made payable to Randy Blackmond for $25.00. 2) Call my board and register
  389.      with your Visa/MasterCard/American Express. If you use this option, you
  390.      will be given a Registration Number by my MC-Visa-AmEx Door that will
  391.      allow you to replace the "UNREGISTERED" notice with your name and your 
  392.      board name. If you register by mail, you will need to create a user 
  393.      account for me on your BBS and write in my password on the mail-in 
  394.      registration form. I will call your board and give you your registration
  395.      number in a private message.
  396.  
  397.      ------------------------------------------------------------------------
  398.  
  399.      Randy Blackmond
  400.      RR #1 Box 634                          RAMail 2.2 Door Registration Form
  401.      Anthony, NM 88021
  402.  
  403.      NAME: _______________________________  ADDRESS: ________________________
  404.  
  405.      CITY, STATE, ZIP CODE : ________________________________________________
  406.  
  407.      HOME VOICE PHONE: _____________________ BBS NAME: ______________________
  408.  
  409.      BBS PHONE: _____________________ BAUD RATES SUPPORTED: _________________
  410.  
  411.      RANDY'S PASSWORD: ______________
  412.  
  413.      COMMENTS: ______________________________________________________________
  414.  
  415.      ________________________________________________________________________
  416.  
  417.      ________________________________________________________________________
  418.  
  419.